home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / gus / umid108.zip / README < prev    next >
Text File  |  1994-02-18  |  30KB  |  657 lines
  1.  
  2.                                            A d v a n c e d
  3.                    ▄▄▄▄  ▄▄▄▄▄    ▄▄▄▄  ▄▄    ▄▄ ▄  ▄▄▄▄▄
  4.                   ▐  ▄▄  ▐    ▌  ▐█  █▌ ▐█    █▌ █ ▐▄▄▄▄▄
  5.                   ▐    ▌ ▐▀▀█▀  ▐█    █▌ ▐█  █▌  █       ▌
  6.                    ▀▀▀▀  ▀   ▀  ▀      ▀  ▀▀▀▀   ▀  ▀▀▀▀▀
  7.                   Advanced Gravis Computer Technology Ltd.
  8. 
  9.       Fax (604) 431-5155                   BBS  (604) 431-5927 V32bis
  10.       Compuserve: GO PCVENB (71333,350)    InterNET EMail: tech@gravis.com
  11.       FidoNET: 1:153/978                   SBCNET: 13:900/3
  12.       AOL: Adv Gravis                      Genie: Page M805 Topic 6
  13.  
  14.                UltraMID TSR V1.08 (UMID108.ZIP - 02/18/94)
  15.  
  16.                        1.0 About these Drivers
  17.                        2.0 Installation
  18.                        3.0 Who Supports
  19.                        4.0 Revision history and Packing List
  20.                        5.0 Troubleshooting
  21.  
  22.                  DEVELOPERS: read the developr.txt file
  23.  
  24. 1.0.0 *************** CHAPTER 1. - ABOUT THESE DRIVERS *******************
  25.  
  26. 1.1.0 What is UltraMID
  27.        ================
  28.  
  29.  The Advanced Gravis UltraSound card is a unique sound card in the
  30.  sound card industry.  It is the only audio product for the PC that can
  31.  produce realistic sounding instruments without requiring an expensive
  32.  digital signal processor.  Digital signal processors (DSPs) are
  33.  relatively expensive microprocessors that are designed specifically
  34.  for working with audio and visual data.  UltraMID is a software version
  35.  of a DSP.  It provides an extremely easy way for software developers to
  36.  write software for the UltraSound card.
  37.  
  38. 1.2.0 What does UltraMID do for me
  39.        ============================
  40.  
  41.  Most of the new games that are released that support the UltraSound
  42.  card will use UltraMID for midi music and digital synthesis.  There
  43.  are titles being released from almost 100% of the major game comapanies
  44.  that use UltraMID.  Each of these games will ship with its own version
  45.  of UltraMID.  However many games that are already out on the market
  46.  can be adapted to use UltraMID.  Any games that uses the "Audio Interface
  47.  Libraries" from Miles Design, Inc., (AIL), or DIGPAK from The Audio
  48.  Solution, can use UltraMID.  AIL and DIGPAK drivers have been included
  49.  with UltraMID so that you can get older software to work with the
  50.  UltraSound card.
  51.  
  52. 1.3.0 Audio Interface Libraries (AIL) - MIDPAK/DIGPAK
  53.        ===============================================
  54.  
  55.  The Audio Interface Libraries (AIL), (we know them as "Miles" Drivers)
  56.  and DIGPAK are a set of interface drivers which enable software
  57.  developers (mainly game developers) to integrate sound capabilities
  58.  into their programs.  Once a developer has integrated his program into
  59.  the AIL drivers the application will work with all sound cards on the
  60.  market who provide AIL drivers. The AIL's provide support for MIDI as
  61.  well as the Digital Sound interface of an audio card. These library
  62.  drivers allow the developers to use UltraSound's wavetable synthesizer
  63.  and allow them to utilize the UltraSound's digital interface to play 8
  64.  or 16 bit audio in either mono or stereo mode.
  65.  
  66.  Advanced Gravis & FORTE have recently designed and released to Miles
  67.  Design and The Audio Solution Inc. the AIL and DIGPAK routines for the
  68.  UltraSound card which provide the mechanism for developers to easily
  69.  integrate with, and use UltraSound's features.  Developers who have
  70.  the AIL's and/or DIGPAK can get the driver updates and integrate
  71.  their programs into the UltraSound.  The AIL/DIGPAK updates will also
  72.  be available through the Advanced Gravis BBS or any of our nodes.  
  73.  Please refer to GRAVNODE.TXT for a complete list. Developers who do
  74.  not have the AILs can get them from Miles Design and/or DIGPAK from
  75.  The Audio Solution Inc.
  76.  
  77.  Developers who want to take full advantage of UltraSound's advanced
  78.  features; and do not want to pay either Miles Design or The Audio
  79.  Solution Inc. license fees, Advanced Gravis and FORTE have a stand
  80.  alone driver as well.  These drivers use a Terminate and Stay
  81.  Resident (TSR) utility called UltraMID.  Developers utilizing this
  82.  TSR are able to do digital playback at 8 or 16 bits up to 44.1kHz
  83.  sample rate.  Also, this allows programmers to use all of the
  84.  UltraSound's 32 digital voices as well as the superior wavetable
  85.  synthesizer.
  86.  
  87.  These drivers are another level of support for the UltraSound card
  88.  developers.  Both the AIL and DIGPAK interfaces provide a means
  89.  for programmers to easily design software for many sound cards using
  90.  only one API while Advanced Gravis/FORTE's stand alone TSR allows
  91.  developers to take advantage of UltraSound's more advanced features.
  92.  
  93.       ....................... END of Chapter 1 ...........................
  94.  
  95. 2.0.0 ****************** CHAPTER 2. - INSTALLATION ***********************
  96.  
  97.  If you are reading this you have probably already unzipped
  98.  all the files into a directory.  Once this is done type "UMINSTALL".
  99.  This program will copy ULTRAMID.INI to your ULTRASND\MIDI directory,
  100.  and ULTRAMID.EXE to your ULTRASND directory.  It does this by
  101.  looking for your ULTRADIR environment variable.  It will also verify
  102.  all of your patches to make sure that they are compatible with UltraMID.
  103.  
  104.  Once the install is completed, you can start ultramid by simply
  105.  typing "ultramid" at the DOS prompt.
  106.  
  107. 2.0.1 installing the AIL, or DIGPAK drivers.
  108.  
  109.  If you have a game that uses the AIL or DIGPAK drivers and you
  110.  would like to get that game to use UltraMID, read this section.
  111.  
  112.  Now for the tough part. First, find a game that uses the AIL or
  113.  DIGPAK/MIDPAK drivers.  A partial list is provided at the end of
  114.  this README.  To determine if a game uses the AIL drivers look for
  115.  files that end with ".ADV".
  116.  
  117.  FIRST, you should make a backup of the games current .ADV drivers,
  118.  just in case something happens.  What we will now do is overwrite 
  119.  some of these files with the Gravis drivers.  
  120.  
  121.  A table is provided below with some guidelines on which files you
  122.  should overwrite:
  123.  
  124.          COPY FROM      COPY TO      CONFIGURE THE GAME AS
  125.          =================================================
  126.          GF1MIDI.ADV    MT32MPU.ADV  Roland
  127.          GF1DIGI.ADV    SBDIG.ADV    Sound Blaster
  128.              OR
  129.          GF1MIDI.ADV    SBFM.ADV     Sound Blaster
  130.          GF1DIGI.ADV    SBDIG.ADV
  131.              OR
  132.          GF1MIDI.ADV    MT32MPU.ADV  Roland
  133.          GF166.COM      SBLASTER.COM Sound Blaster (DIGPAK)
  134.  
  135.  By looking at the names and size of the .ADV drivers you should be able
  136.  to determine which cards they are for.  For example:
  137.  
  138.     ADLIB    ADV     14693 07-07-92   6:00a  = Adlib
  139.     ADLIBG   ADV     16175 07-07-92   6:00a  = Adlib Gold
  140.     ARIAXMID ADV     44836 03-26-93  10:26a  = Aria
  141.     MT32MPU  ADV     10590 03-16-92  12:00p  = Roland
  142.     MULTISND ADV      7042 03-09-93  12:51p  = Turtle Beach
  143.     PASFM    ADV     15160 07-07-92   6:00a  = Pro Audio Spectrum
  144.     PCSPKR   ADV      8306 03-16-92  12:00p  = PC Speaker
  145.     SBFM     ADV     14743 07-07-92   6:00a  = Sound Blaster
  146.     SBP1FM   ADV     15153 07-07-92   6:00a  = Sound Blaster Pro
  147.     GF1DIGI  ADV      5248 08-14-93   3:49p  = UltraSound Digital
  148.     GF1MIDI  ADV     10816 08-14-93   3:50p  = UltraSound MIDI
  149.  
  150.  In general if any .ADV file is > 10K it is the music driver and should
  151.  be copied over with GF1MIDI.ADV.  If any .ADV file is < 10K it is the
  152.  digital audio driver and should be replaced with GF1DIGI.ADV
  153.  
  154.  Once this is done simply run the games setup and select whatever
  155.  sound card that you just over wrote with the Gravis drivers.
  156.  For example, if you copied over top of the Sound Blaster and Roland
  157.  drivers then you would configure the game for sound blaster roland.
  158.  
  159.  That is it.  If everything is working correctly you should now be
  160.  getting UltraSound support in that game.  If not please refer
  161.  to the trouble shooting section in chapter 5.
  162.  
  163.  
  164. 2.1.0 Hints and Tricks
  165.        ================
  166.  
  167.  - In theory you could copy over top of ANY of the .ADV drivers as
  168.    long as you know which sound card to configure the game for.
  169.  
  170.  - Some programs do not use the regular naming convention for .ADV
  171.    drivers, for instance Ultima Underworld II by Origin.  The
  172.    convention for UW2 is DM*.ADV, and DD*.ADV.  The DM is for
  173.    MIDI and the DD is for digital audio.  Since we can't tell by
  174.    looking at the file name which sound card these drivers are for
  175.    you may just want to copy GF1DIGI.ADV overtop of ALL DD*.ADV
  176.    files and GF1MIDI.ADV overtop of all DM*.ADV drivers.
  177.  
  178.   REMEMBER TO BACKUP YOUR ORIGINAL .ADV DRIVERS
  179.  
  180.  - In theory, a game should be looking in its sound driver directory
  181.    for any files with a .ADV extention, then present the user with a
  182.    list of the sound card drivers found.  For instance, in Spell
  183.    Caster 2000 you simply have to copy the GF1*.ADV drivers into
  184.    its directory.  It will then detect these drivers and you may choose
  185.    ULTRASOUND from its setup menu. This is the only game so far that
  186.    I've been able to find which does this.
  187.  
  188.  - (06/22) Origin uses a slightly modified version of the AIL drivers.
  189.    As such their games may sound slightly off or not work at all with
  190.    our drivers. An example of this is Strike Commander, which will not
  191.    work at all with the standard AIL interface.
  192.  
  193.  - We have found some games that use both the AIL drivers and access the
  194.    sound hardware directly.  An example of this type of game is EYE OF
  195.    THE BEHOLDER.  Since these type of games do not rely soly on the AIL
  196.    drivers and try to access the hardeware directly they may not work
  197.    with these drivers.
  198.  
  199.  
  200. 2.2.0 Command Line Switchs
  201.        ====================
  202.  
  203.  ULTRAMID by default will try to preload patches for all MIDI songs.
  204.  This will give you the best quality sound but may not be compatible
  205.  with all games.  If you start ULTRAMID but can't get the game to
  206.  make any music, try reloading ULTRAMID with the -C parameter.
  207.  
  208.  e.g. lh ultramid -c -m100 -nultramid.ini -dc:\game\
  209.  
  210.  The above example will load UltraMID high, preload a patch library, sets
  211.  the master volume at 100, looks for an .INI file named Ultramid.ini and
  212.  tells UltraMID to look in the C:\game directory for the configuration
  213.  file.
  214.  
  215.  -C    - Preloads a 256K, 512K 768K or 1024K patch library, depending
  216.        on how much memory you have on your UltraSound card. UltraMID
  217.        automatically detects how much memory is on your card.  This
  218.        option does not sound as good as patch cacheing but should
  219.        work with all games.
  220.  -F    - Unload ULTRAMID from memory
  221.  -Mxxx - [1-127] Sets the master volume for music.  In some games the
  222.        music may over power the speech.  If so you can use this
  223.        switch to adjust the master volume as required. The default
  224.        volume is 127.
  225.  -Nfilename
  226.        - Tell UltraMID not to use ultramid.ini, but look for an
  227.        initialization file named "filename"
  228.  -Dpath
  229.        - Use an alternate path for finding the ultramid configuration
  230.        file and for finding patches. The path should include a
  231.        trailing backslash (e.g.) -Dc:\game\
  232.  -Q    - Quiet.  Don't display any messages.
  233.  -16   - Load patches as 16 bit instead of 8 bit. This will cause only
  234.        half the number of patches to be loaded.
  235.  
  236.  
  237. 2.3.0 Limitations of AIL and DIGPAK
  238.        =======================
  239.  
  240.  The Audio Interface Libraries and DIGPAK each only give access to
  241.  ONE STEREO digital channel.  Since the UltraSound is capable of 32
  242.  independent digital channels this poses quite a limitation.  The
  243.  file UMDOC.ZIP on the Advanced Gravis BBS has detailed technical
  244.  documentation on how to write programs that use UltraMID.  UltraMID will
  245.  let you play multiple simultaneous digital audio tracks as well as
  246.  general midi music.
  247.  
  248.  
  249. 2.4.0 Support
  250.        =======
  251.  
  252.  These AIL, MIDPAK/DIGPAK drivers are intended for developers who
  253.  will be releasing future programs that use the AIL drivers.  We
  254.  are releasing these to the general public so that you may attempt
  255.  to patch older games to include direct UltraSound support.
  256.  
  257. 2.6.0 General Information
  258.        ===================
  259.  
  260.  - We currently support V3.2 of the DIGPAK standard.
  261.  
  262.  - We currently support V2.0 of the AIL standard.
  263.  
  264.  - You may have heard the names 'John Miles' and 'John Ratcliff' and
  265.    wondered who they are.  John Miles is Miles Design, the designer and
  266.    creator of the Audio Interface Libraries.  John Ratcliff is The
  267.    Audio Solution (MIDPAK/DIGPAK). They are two seperate companies who
  268.    work together towards the same goal.  A standard interface for
  269.    sound cards.
  270.  
  271.  - Documentation on how to program directly for ULTRAMID will be made
  272.    available in the future by Forte and Advanced Gravis.
  273.  
  274.  - If you are interested in AIL or MIDPAK/DIGPAK you may contact Audio
  275.    Solutions at any of the numbers provided later on in this README.
  276.  
  277.  - ULTRAMID will look for your ULTRADIR environment variable to locate
  278.    your MIDI directory.  ULTRAMID.INI must reside in your MIDI directory.
  279.  
  280.  - Tech NOTE: Developers: Please use a multiple of 32 bytes for sound
  281.    buffers.  The Gravis UltraSound card can only DMA to 32 byte
  282.    boundaries; so to reduce UltraMID overhead, a multiple of
  283.    32 bytes will mean no polled I/O.
  284.  
  285.  - (06/22) Sierra and Lucas do NOT use either the AIL drivers or DIGPAK.
  286.    Sierra has drivers available for their general midi games that use
  287.    UltraMID.
  288.  
  289.  - (06/22) If possible try copying overtop of the SCC1 or general midi
  290.    drivers.  As some games will load up a different (usually better)
  291.    music score.  An example of this is the 7th Guest.
  292.  
  293.  
  294.       ....................... END of Chapter 2 ...........................
  295.  
  296. 3.0.0 ****************** CHAPTER 3. - WHO SUPPORTS ***********************
  297.  
  298. 3.1.0 The Audio Solution
  299.        ==================
  300.  
  301.  The following is a list obtained from the Audio Solution BBS
  302.  (PRODUCTS.LST). It is a little out of date but does include some
  303.  information on which game publishers are licensed to use
  304.  these drivers.
  305.  
  306.              THE AUDIO SOLUTION
  307.              P.O. Box 11688
  308.              Clayton, MO 63104
  309.  
  310.      Order/Information: (314)-567-0267 9am-5pm Central Mon-Fri
  311.      Technical Support: (314)-926-0232 9am-5pm Central Mon-Fri
  312.      BBS:               (314)-939-0200 24 hours 7 days.
  313.  
  314.  
  315.              MILES DESIGN, INC.
  316.              6702 Cat Creek Trail
  317.              Austin, TX, 78731
  318.      (512) 345-2642 / FAX (512) 338-9630 / BBS (512) 454-9990
  319.  
  320.  
  321.          DIGPAK/MIDPAK COMPLETE PRODUCT LIST
  322.                (as of 1/3/93)
  323.  
  324.      This list does not reflect all products produced by product line
  325.      licensees; since we are not always informed of those products as
  326.      they are released.  It also does not reflect the products in
  327.      development (over 100) which use either DigPak and MidPak.
  328.  
  329. Product Name            Publisher                    Use
  330. ===========================================================================
  331. <unamed>                Epyx                         DigPak+MidPak
  332. ATC/Tracon              Wesson International         DigPak
  333. Animal Quest            Alive Software               DigPak+MidPak
  334. Battle Chess 4000       Interplay                    DigPak
  335. Battle Cruiser 3000AD   Three-Sixty Pacific          DigPak
  336. Beyond Shadowgate       ICOM Simulations             DigPak+MidPak
  337. Bilou                   Concepteva                   DigPak
  338. BodyLink                Stragem                      DigPak
  339. Chess Maniac 5,000,001  Spectrum Holobyte            DigPak+AIL
  340. Chessmaster 3000        The Software Toolworks       DigPak
  341. Contraption ZAck        Presage Software Co. Inc.    DigPak+MidPak
  342. Creepers                Destiny Software             DigPak+MidPak
  343. Cribbage Master         Ninga                        DigPak
  344. Cyberstrike             Simutronics                  DigPak
  345. DNA Parrot              T&t Research                 DigPak
  346. Dinosaur Adventure      Knowledge Adventure          DigPak
  347. Fun Univ Ntwk Intfc     Fun Univ Netwk               DigPak+MidPak
  348. Gateway to the Savage   Strategic Simulations Inc.   DigPak
  349. Gateworld Trilogy       Home Brew Software           MidPak
  350. GemStone III            Simutronics                  DigPak
  351. Grandmaster Chess       IntraCorp                    DigPak+MidPak
  352. Guardians of Eden       Access Software              MidPak
  353. Guzzle Puzzles          Redwood Games                DigPak
  354. Inspector Gadget:       Azeroth Publishing           DigPak+MidPak
  355. KidDesk                 Edmark Corporation           DigPak
  356. Layout for DOS          Objects, Inc                 DigPak+MidPak
  357. Le Ponctueur            C.R.A.P.O., Inc.             DigPak
  358. Magic Crayon            Alive Software               DigPak+MidPak
  359. Marvin The Moose        Milliken Publishing          DigPak
  360. Math Sequences          Milliken Publishing          DigPak
  361. Math Zone               Milliken Publishing          DigPak
  362. Mechwarrior II          Activision                   DigPak
  363. MicroLeague Baseball IV Microleague Sports Assoc.    DigPak+MidPak
  364. MicroLeague Football II Microleauge Sports Assoc.    DigPak+MidPak
  365. Microleage Cards        Microleage Sports Assoc.     DigPak
  366. Millie's Math House     Edmark Corpoartion           DigPak
  367. Milliken Storyteller    Milliken Publishing          DigPak
  368. Monopoly Deluxe         Virgin Games                 DigPak+MidPak
  369. Mutanoid Math Challenge Legacy Software              DigPak+MidPak
  370. Mutanoid Word Challenge Legacy Software              DigPak+MidPak
  371. My Paint                Saddleback Graphics          DigPak
  372. Oregon Trail Deluxe     MECC                         DigPak+MidPak
  373. Pickle Wars             Redwood Games                DigPak+MidPak
  374. Places to Play          Magnetic Images              DigPak
  375. Pools of Darkness       Strategic Simulations Inc.   DigPak
  376. Ragarok (Valhalla)      Norsehelm Productions        DigPak
  377. Realms of Avarton       Kram                         DigPak
  378. Return to Zork          Activision                   DigPak
  379. Shadow President        DC True                      DigPak
  380. Sights & Sounds         Macmillan/McGraw Hill        DigPak
  381. Solitaire's Journey     Quantum Quality Productions  DigPak+MidPak
  382. Space Adventure         Knowledge Adventure          DigPak
  383. Space Chase 1,2,3       Safari Software              MidPak
  384. Spaceward Ho PC         Presage Software Co. Inc.    DigPak+MidPak
  385. Stepping Stones Bonus   Compu-Teach, Inc.            DigPak+MidPak
  386. Stickybear Townbuilder  Optimum Resource             DigPak
  387. Switch Progressions     Cooper, R.J. & Assoc.        DigPak+MidPak
  388. Switch Quik             Cooper, R.J. & Assoc.        DigPak+MidPak
  389. T-Zero                  Dennis Cunningham            DigPak+MidPak
  390. Terminator 2029         Bethesda Softworks           DigPak
  391. The 7th Guest           Virgin/Trilobyte             DigPak+AIL
  392. Tom Landry Football     Merit Software               DigPak+MidPak
  393. VGA Jigsaw              Alive Software               DigPak+MidPak
  394. Waterford Mental Math   Waterford Institute          DigPak+MidPak
  395. Wheel of Fortune        Gametek                      DigPak+MidPak
  396. WorldAtlas              The Software Toolworks       DigPak+MidPak
  397.  
  398. Product line licensees of DigPak and/or MidPak.  Product line licensees
  399. have the rights to include DigPak and MidPak in any product produced by
  400. their company.
  401.  
  402.           Electronic Arts
  403.           Activision
  404.           Spectrum Holobyte
  405.           The Software Toolworks
  406.           SSI, Strategic Simulations Inc.
  407.           Milliken Publishing Company
  408.           Commodore Computer
  409.           Virgin Games
  410.           Compu-Teach
  411.           Knowledge Adventure
  412.           Gametek
  413.  
  414. Product line licensees to AIL (Mile Design's Audio Interface Library) which
  415. uses the same MIDI drivers as MIDPAK.
  416.  
  417.           Activision
  418.           Strategic Simulations
  419.           Electronic Arts
  420.           Origin Systems
  421.           Spectrum Holobyte
  422.           Virgin-Games
  423.           Knowledge Adventure
  424.           Bethesda Softworks
  425.           Interplay
  426.           Microprose
  427.           Gametek
  428.           Impressions
  429.           Mindscape UK
  430.  
  431.  
  432. 3.2.0 Other Products Found to use these Drivers
  433.        =========================================
  434.  
  435.   Great Naval Battles
  436.   Tony La Rusa Baseball II
  437.   War of Two Worlds
  438.   Spell Caster 2000
  439.   Trump Castle III
  440.   Buzz Aldrin's Race To Space
  441.   Clash of Steel - World War II Europe 1939-45
  442.   SimCity Classic
  443.   SimFarm
  444.   Dark Sun
  445.   Kids Zoo
  446.   SSN Sea Wolf
  447.   Terminator Rampage
  448.  
  449.       ....................... END of Chapter 3 ...........................
  450.  
  451. 4.0.0 *************** CHAPTER 4. - ABOUT THIS UPDATE *******************
  452.  
  453. 4.1.0 Revision History
  454.        ================
  455.  
  456.  V1.08  - (02/18/94) Fixed problems with percussion sounding poor.
  457.                      Fixed divide by zero errors.
  458.  V1.05  - (11/05/93) -D switch will first search for patches in current
  459.                      directory before looking in your ULTRASND\MIDI
  460.                      directory.
  461.  V1.04  - (10/28/93) Added -16 switch to load patches at 16 bit
  462.                      Fixed 16 bit digital audio problem in DIGPAK
  463.  V1.03  - (09/15/93) MIDI in support for sequencers added
  464.  V1.02a - (09/02/93) Digital Audio improved
  465.  V1.02  - (09/01/93) All notes off midi message fixed
  466.  V1.01  - (08/31/93) This UltraMID offers much faster patch loading than
  467.              the previous version, and is about 3K smaller.
  468.              It also can load almost twice as many patches as
  469.              it used to in the same amount of PC memory.  (You
  470.              are still bound by the size of your UltraSound card
  471.              however.)
  472.  
  473.              This release also fixes several small bugs.
  474.              1) DMA bug while loading patches.
  475.              2) ULTRAMID.INI problems.
  476.              3) Noises during patch loading.
  477.  
  478.              New Features:
  479.              1) Automatically removes SBOS.
  480.              2) Can split up its code and data so that if you
  481.                 have fragmented upper memory or not enough
  482.                 upper memory, UltraMID can still load a
  483.                 portion of itself high.
  484.  
  485.              PS: REMEMBER TO RUN the UMINSTAL.EXE program.
  486.  V1.0   - (06/25/93) Yes, a version 1.0 release
  487.  V0.97B - (06/22/93) Fifth Beta - Fixed DMA bug.
  488.               Fixed patch loading bug.
  489.               Fixed xmidi multi-sequence bug.
  490.               Fixed digital hang bug.
  491.               Fixed problem with 512K patch library
  492.  V0.96B - (06/17/93) Fourth Beta - Fix DIGPAK buffering
  493.  
  494. 4.2.0 Packing List
  495.        ============
  496.  
  497.  ULTRAMID.EXE     AIL TSR - Required for drivers
  498.  GF1MIDI.ADV      UltraSound MIDI AIL Driver
  499.  GF1DIGI.ADV      UltraSound Digital Audio AIL Driver
  500.  GF166.COM        UltraSound DIGPAK Driver
  501.  UM200.INI        Patch Map for 2.00 - 2.05 UltraSound software releases
  502.  UM206.INI        Patch Map for 2.06 UltraSound software releases
  503.  UM206a.INI       Patch Map for 2.06 UltraSound software releases
  504.  MT32.INI         Patch Map for MT32
  505.  
  506.  README           This README file
  507.  GV.EXE           Gravis Document Viewer
  508.  UMINSTAL.EXE     Installs the correct .INI file and UltraMID.EXE in your
  509.                   ULTRASND directory.
  510.  GRAVNODE.TXT     List of Gravis BBS Nodes
  511.  SDKORDER.TXT     Gravis SDK Order form
  512.  PUPDATE.EXE      Used to fix .PAT files if necessary. READ Troubleshooting
  513.  DEVELOPR.TXT     Note to Developers
  514.  
  515.       ....................... END of Chapter 4 ...........................
  516.  
  517. 5.0.0 *************** CHAPTER 5. - TROUBLESHOOTING ***********************
  518.  
  519.  I copied the drivers on top of other drivers, but now the game says that
  520.  it can't find the sound card:
  521.  
  522.      1) Most games require running a set-up program to tell it that you
  523.     have changed sound cards.  Try finding such a program and running
  524.     it.  It most likely will not show Gravis or Ultrasound in the list
  525.     of available drivers, so you will have to pick the sound cards which
  526.     you copied the AIL or DIGPAK drivers to.
  527.      2) Some games use modified AIL or DIGPAK drivers.  Most of the games
  528.     from Origin have been modified and therefore are not compatible with
  529.     these drivers.
  530.      3) Some games only use the AIL or DIGPAK drivers for certain
  531.     operations. For the rest of them operations it may try to access
  532.     the sound hardware directly.  These type of games will not work
  533.     with UltraMID and our AIL/DIGPAK drivers.
  534.  
  535.  I have sucuessfully installed the drivers for a game, but sometimes the
  536.  music seems strange, as if its missing notes, or completely quiet:
  537.  
  538.      1) Restart UltraMID with the -c option to preload instruments.  Most
  539.     music will take more than 256K of memory. 768K to 1Mb is the
  540.     optimal setup for the UltraSound card. (.e.g.)
  541.         C> ultramid -f
  542.         C> lh ultramid -c
  543.      2) If you have replaced any of your patches with non-Gravis patches,
  544.     the size may be different. The patch sets in ULTRAMID.INI are
  545.     configured so that your UltraSound card will be loaded with as
  546.     many patches as will fit into its available memory. Leaving 8K
  547.     for digital audio.  This means, if you try and load a patch
  548.     that is 4K bigger than the original, than there will only be a
  549.     4K buffer left instead of an 8K, and the drivers may not be
  550.     able to load correctly.
  551.      3) Your patches may be out of date.  A program called pupdate.exe is
  552.     available which will repair old or bad patches.  doo.pat is an
  553.     example.  run pudate like this:
  554.  
  555.        pupdate -check_patch -force_update *.pat
  556.  
  557.     in your ultrasnd\midi directory.  Pupdate will show you incorrect
  558.     patches and ask if it should update them.  Answer yes to all of
  559.     your patches EXCEPT BLANK.PAT.  BLANK.PAT is meant to be silent
  560.     and should not be corrected.  Pupdate will also create backups of
  561.     all of your patches as it modifies them.  acpiano.pat will become
  562.     acpiano.pa1.  acpiano.pa1 will become acpiano.pa2, etc.  The
  563.     install program uminstal.exe will check all of your patches during
  564.     the install.
  565.     
  566.  Playback of digital audio sounds choppy.
  567.      1) Your disk or CD may be too slow, and the sound card plays sound faster
  568.     then your disk can retrieve data.
  569.      2) The UltraSound cannot play interleaved stereo data, and must use
  570.     your pc to seperate the left and right channel data before playback.
  571.     Slower 286 or 386 machines may not be able to keep up with high
  572.     speed, high fidelity audio.
  573.      3) The game is using audio buffers which are too small for
  574.     the UltraSound to effectively "double buffer" the data.  The
  575.     technique called "double buffering" provides clear sound without
  576.     clicks or pauses in audio, and smooth animations in video.
  577.     Optimal data sizes for UltraMID are multiples of 2K for stereo
  578.     data and multiples of 4K for mono data.  Some audio cards that
  579.     uses the DMA hardware for playback may call this technique
  580.     backfill DMA.  The UltraSound only uses the DMA hardware for data
  581.     transfers; the GF1 actually produces the sound.
  582.  
  583.  When I run ULTRAMID I get a 'error loading patch' message.
  584.      1) You must be running the patches that came with the V2.x software.
  585.     This includes V2.0, V2.2, V2.4, V2.5 and the latest V2.6 disk sets.
  586.      2) A patch may either be missing or corrupt. If you are unable to
  587.     determine which one simply reinstall the patches.
  588.  
  589.  The games says that it can't run because there is not enough memory.
  590.      1) If you are using an Expanded Memory Manager (emm386, qemm, bluemax,
  591.     386max, etc) you can load the driver into high memory to provide
  592.     more conventional memory for your game.  If you Expanded Memory
  593.     manager supports the dos LH command, make sure the following
  594.     line is in your config.sys:
  595.         DOS=HIGH,UMB
  596.     If you are using DOS 5 or DOS 6, you can use the LH command to
  597.     load UltraMID into high memory.  For example: LH ultramid -m100 -c
  598.     will load ultramid into high memory, set the master volume to
  599.     100 (out of 127), and preload as many patches as will fit into
  600.     your UltraSound card. NOTE: 386MAX uses its own command to
  601.     load programs into upper memory instead of LH.
  602.      2) If you cannot use an Expanded Memory Manager but can use an
  603.     extended memory manager (himem.sys), then also include the
  604.     DOS=HIGH,UMB line in your config.sys so that DOS will be loaded
  605.     into upper memory.
  606.      3) If you can't fit UltraMID into high memory, try loading other
  607.     drivers or TSR's into high memory using DEVICEHIGH= instead
  608.     of DEVICE= in your config.sys and LH in your autoexec.bat files.
  609.      4) DOS 6 comes with a utility called MEMMAKER that will help you
  610.     optimize the use of memory on your machine.  QEMM comes with
  611.     a utility called optimize to help you optimize your memory.
  612.     BLUEMAX and 386MAX also have programs to help you maximize
  613.     the use of expanded and extended memory.
  614.      5) If there are other drivers in your system that you don't need
  615.     to play the game, try making a floppy disk with just the programs
  616.     you need to get your machine running.  For example,
  617.          FORMAT /s a:
  618.     will format a disk in the "A" drive and copy MS-DOS to it.  Then
  619.     create a minimal config.sys and autoexec.bat such as:
  620.  
  621.     CONFIG.SYS:
  622.      DEVICE=C:\DOS\HIMEM.SYS
  623.      DEVICE=C:\DOS\EMM386.exe ram
  624.      DOS=HIGH,UMB
  625.      SHELL=C:\DOS\COMMAND.COM C:\DOS\ /E:768 /p
  626.      files=20
  627.      buffers=20
  628.      LASTDRIVE = D
  629.  
  630.     AUTOEXEC.BAT:
  631.      PATH C:\DOS;C:\ULTRASND;C:\UTILS
  632.      SET ULTRASND=220,1,1,11,7
  633.      SET ULTRADIR=C:\ULTRASND
  634.      SET BLASTER=A220 I7 D1 T1
  635.      LH C:\UTILS\MOUSE
  636.      LH ULTRAMID -m100
  637.      rem if you have the memory available, and you are not using
  638.      rem the -c option, Smart Drive improves the performance
  639.      rem for loading patches tremendously.  I have  8Mb on my
  640.      rem machine, so I usually set up a 4Mb disk cache.
  641.      LH C:\DOS\smartdrv /Q 4096 0 c
  642.  
  643.     These examples are for experienced DOS users, and probably won't
  644.     work with your machine without some modification.  Please consult
  645.     your DOS manual or a book that covers memory management to get more
  646.     hints on how to manage PC memory.
  647.  
  648.      6) If you can't get UltraMID to load into high memory and you
  649.     don't need an EMS memory, then load emm386 with the option noems.
  650.     This will give you 64K more room for UltraMID to load.
  651.  
  652.       ....................... END of Chapter 5 ...........................
  653.  
  654.  
  655.                                   THE END
  656.  
  657.